home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The X-Philes (2nd Revision)
/
The X-Philes Number 1 (1995).iso
/
xphiles
/
hp48hor1
/
roldx.doc
< prev
next >
Wrap
Text File
|
1995-03-31
|
6KB
|
168 lines
ROLDX.LIB Copyright 1990 Tom Mullin
Program: ROLDX.LIB
Target: HP48 with serial cable
Bytes: 3714
Checksum: #8F69h (when stored as object)
Version: 1.0
Date: 9-12-1990
-----------------------------------------------------------------
Features:
- Holds name, address, and phone numbers. Allows for quick access to
any one entry. The entries are sorted on last name as they are entered.
The program mimics an actual rolodex. To find a name zero in on the
first letter of the last name then leaf thru the remaining entries.
- The program is contained in library for reduced clutter.
- Data is kept in user memory. All Data is kept in just one file.
Just the data needs to be backed up. The program will start a new
data file if one is not present.
- The program can be invoked from anywhere and will pop up current
entry.
- The program will cleanup after itself restoring: stack, flags,
directory and menu.
-----------------------------------------------------------------
Installation:
- Copy the file roldx.lib to your root directory.
- Recall the file to the stack.
- Type :0:1 STO ENTER to store the library in port 0.
- Purge roldx.lib (it isn't needed anymore)
- Turn the 48 off then on. The display should blink.
- Type :0:807 ATTACH to attach the library to the home directory.
-----------------------------------------------------------------
Program Invocation:
- First use the installation procedure detailed above.
- The program can be run by selecting it from the library menu. It
can also be executed by typing ROLDX. Because the library is
attached to the home directory it can be accessed anywhere.
- If desired, the program can be attached to a key:
Example:
Type << ROLDX >> 45.3 ASN to assign the program to
the LOG key in user mode.
-----------------------------------------------------------------
Using the Rolodex
- The first time the program is invoked it will create an empty
database in the current directory. You should be in the home
directory the first time you invoke the rolodex. See the section below
on placement of files.
- The active menu keys : [EXIT] [ADD] [EDIT] [DEL] [PREV] [NEXT]
- [EXIT] This will exit the program. The stack, directory, flags,
and menu will be restored.
- [ADD] The user will be prompted to enter the four fields of an
entry: first name, last name, address (use CR\LF to separate
multiple lines), and phone number. The ENTER bar will end each
entry. The two name entries enable sorting the phone list
alphabetically on the last name. If no first name leave that entry
blank.
Example: Educalc would not have a first name entry
and would be sorted under the 'E''s.
Example: Joe Smith would be sorted under the 'S''s.
All entries wider then two characters will be converted to
mixed case.
- EDIT: The current entry will be edited. The user will be
prompted for the field to edit. The ENTER bar will end an entry.
- DEL: The user will be prompted to delete the current entry.
- PREV: The previous entry will displayed.
- NEXT: The next entry will be displayed.
-----------------------------------------------------------------
Speed Searching Keys:
- The A-Z keys can be used to quickly go to any entry.
- [G - Z,' '] Push the key and the first entry that starts with
that letter will be displayed.
Example: The number of Joe Smith is desired. Push 'S'. The
First 'S' entry will be displayed. Push the 'S' key repeatedly to
view all the 'S' entries.
If an entry's last name doesn't start with a letter A-Z then
it will be stored at the end of the database. The space key will
go right to these entries. Repeatedly pressing this key will view
all these non alphabetical entries.
- [alpha A-F] Because of the menu keys the alpha shift key will
have to be pressed first to speed search the letters 'A' - 'F'.
Example : The number of Educalc is to be displayed. Push the
alpha shift key then 'E'. The first 'E' entry will then become the
current entry.
-----------------------------------------------------------------
Placement of Files:
The program resides in a library. The data is contained in a
list ('Roldata') that resides in the current directory or the home
directory. If Roldata is in neither of these two locations the
file Roldata will be created in the current directory.
ROLDX should be invoked for the first time from the home directory.
This will place the data file in the home directory making it
accessible from anywhere.
The user can also have multiple phone lists by creating multiple
Roldatas in different subdirectories.
-------------------------------------------------------------------
Thanks to Eric L. Hernes I. for the original HP28 rolodex program
(ITEM #14 comp.sys.handhelds)
Also thanks to HP BBS for the USRLIB program.
Future release:
- Speed Search on more then just the first entry.
- String packing would decrease the 'Roldata' size.
- I wish there was an OBGET function on the HP48. It would
streamline ROLDX. Maybe an assembly language routine would get a
string from a list of lists of strings.
- Allow user to modify number and name of fields to allow for
different databases to be serviced by the same library.
- Have data sorted by separate B-Tree index. User could sort data
on say phone number, city, etc on the fly.
- Add [DIAL] key if it ever becomes possible to use the HP48 as a
phone dialer
ROLDX Copyright 1990 Tom Mullin
This library can be freely distributed under the following conditions:
1) This file must be included with the program if possible.
2) You may not charge money for this library.
Comments: Tom Mullin,
2412 Palm Ave.
Manhattan Beach, CA 90266
213-545-9888 evenings
or tmullin on HP BBS